home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Software Vault: The Gold Collection
/
Software Vault - The Gold Collection (American Databankers) (1993).ISO
/
cdr35
/
pwrlst43.zip
/
PWRLIST.DOC
< prev
next >
Wrap
Text File
|
1993-04-26
|
30KB
|
609 lines
▄▄▄▄▄▄ ▄▄▄▄▄▄ ▄ ▄ ▄▄▄▄▄▄ ▄────▄
█ ▀▄ ▄█ █▄ █ █ █ █ ▀▄
█─────▀ █ █ ▀▄ ┌┐ ▄▀ █──── █───▄─▀
█ ▀█ █▀ ▀▄┌┘└┐▄▀ █ █ ▀▄
▀ ▀▀▀▀▀▀ ▀▀ ▀▀ ▀▀▀▀▀▀ ▀ ▀
▄ ▄ ▄▄▄▄▄▄ ▄▄▄▄▄▄▄
█ █ █▀ ▀ █
█ █ ▀─────▄ █
█ █ ▄ ▄█ █
▀▀▀▀▀▀▀ ▀ ▀▀▀▀▀▀ ▀
version 4.2
by
Mike Weaver
CONTENTS
========
Overview
Copyright
Warranty
Distribution
Registration
List of files in archive
Configuration Files
Environment Variables
Batch File
Sysop Keys
OVERVIEW
--------
Power List is a utility for PCBoard 14.x, although it has not been tested
on any other systems it should work fine with any system that can produce
a DOOR.SYS, PCBOARD.SYS, USERINFO.DAT, DORINFOx.DEF, CALLINFO.BBS and a
few others.
Power List allows the user to design and download a custom built list of
available files on a particular BBS. Hence the name. Rather than tying up
your system to download a very large complete file listing the user selects
those files areas that interest him/her and then Power List will do the rest.
Using PKZip(tm) Power List will compress all the selected file directories
and then using DSZ(tm) it will allow the user to download the list.
Copyright
---------
POWER LIST, Copyright (c) 1992 by Mike Weaver, is being distributed as
Shareware. Under this concept you may use the SHAREWARE (unregistered)
version for a reasonable period of time for evaluation after which you
must either register your copy or discontinue usage.
DISCLAIMER - WARRANTY
~~~~~~~~~~~~~~~~~~~~~
This product is provided as is without warranty of any kind. The entire
risk as to the results and performance of the program is assumed by you.
Futhermore, the author does not warrant, guarantee, or make any other
representations regarding the use of, or the results of the use of the
program, and you rely on the program and results solely at your own
risk. The author cannot and will not accept responsibility for system
damage, loss of profit or any other special, consequential or incidental
damages resulting from the use of or inability to use this product.
Distribution
------------
This program is being distributed via the SHAREWARE concept and as such,
may be copied freely with the following restrictions:
* The program must be supplied in it's original unmodified
form, including documentation.
* This program may not be distributed as part of any commercial
application or service without the express, written consent
of the author.
* Vendors of Shareware/Public Domain software may not
distribute this program without the express, written
consent of the author.
Registration
------------
This door represents many hours of programming and the author deserves
just compensation for his time, efforts and expertise. If you find this
program to be of some value and you continue to use it on your system,
you must return the order form provided along with the registration fee.
Registration entitles you to free upgrades via modem from The NITE-LITE.
Payments should be made in the form of a check or money order. Or you
can register by credit card on The NITE-LITE bbs.
The NITE-LITE bbs: (615) 458-9099 v.32bis
NOTE: After I recieve your registration fee, your registration number
will be posted in a private message on The NITE-LITE.
I have not crippled this program in any way, so you can use it
forever if you like. However be forewarned that unless you
register I may not be apt to answer questions as freely. I
too however realize the cost of running a BBS so I ask only a
mere $15 if you like and use the program. If you do not like
the program and have an idea that would make it more likeable
by all means let me know and I will try to implement it.
List of Files in archive:
-------------------------
Sample.cfg Pwrlist.doc Register.frm
Pwrlist.exe Pwrlist. Pwrlist.hlp
File_id.diz History.doc Powerlistx.exe
SAMPLE.CFG This is the door configuration file. The one included in
this archive is a sample and will have to be edited to fit
your system.
PWRLIST.DOC Three guesses and the first 2 don't count. <Grin>
PWRLIST.EXE The executable door program itself. This door is a stand
alone program that requires no other files such as DoorPatch
or Brun. I wrote this door using DoorFrame 3.8
PWRLISTX.EXE This is the seamless version of PowerList. No intros, no
credits, no fancy screens. This version should make the
door appear to be an intergrated part of your system. This
version will only run if the user has a valid serial number.
PWRLIST. This is a sample batch file to run the door on PCBoard
systems. You may have to edit it depending on where you
store the door files etc.
FILE_ID.DIZ This file contains program descriptions for boards that
implement automatic file description insertion with a
program such as PCBDescribe(tm).
HISTORY.DOC A list of corrections or bug fixes or changes in Power List
REGISTER.FRM Registration form for use when registering by mail.
PWRLIST.HLP Help file required for operation. Must be in the same
directory the door is run from.
Example configuration file for|PCBOARD.SYS|
------------------------------------------
C:\PCB\PCBOARD.SYS <=- (Full pathname of your PCBOARD.SYS file)
The NITE-LITE bbs <=- (Change this to your BBS name)
Mike <=- (The Sysop's first name)
Weaver <=- (The Sysop's last name)
PCBOARD <=- (BBS type must be in caps - only PCB support for now
662345922 <=- (Your registration #) Use this one till you get one
1 <=- (1 = non-standard comport 0 = normal comports)
2e8,5 <=- (Base,Irq for non-standard port) Don't leave this
line blank! If line above is 0 this line will be
ignored.
c:\pcb\menus\dirs <=- (Location of your file directory menu. You need to
have both a non-graphics and graphics version of
this file available. Example: DIRS and DIRSG
NiteLite.zip <=- (Change the name of the .ZIP file PowerList creates)
60 <=- (Number of dir files available)
c:\pcb\gen\dir.lst <=- (Location of the PCBoard Dir.lst file)
c:\pcb\gen\upld <=- (Location of upload dir file)
c:pcb\gen\dos1 <=- (From here to the end of the config file is the
c:pcb\gen\dos2 complete path and filename of each dir file you
c:\pcb\gen\dos3 want to be accessable by PowerList. This is a big
c:\pcb\gen\dos4 change from 3.9 and lower. Files can now be in
c:\pcb\gen\dos5 any location. These lines are needed only for
non-PCBoard systems.)
etc.
Example configuration file for|USERS.SYS|
------------------------------------------
C:\PCB\USERS.SYS <=- (Full pathname of your USERS.SYS file)
The NITE-LITE bbs <=- (Change this to your BBS name)
Mike <=- (The Sysop's first name)
Weaver <=- (The Sysop's last name)
PCBOARD <=- (BBS type must be in caps - only PCB support for now
662345922 <=- (Your registration #) Use this one till you get one
1 <=- (1 = non-standard comport 0 = normal comports)
2e8,5 <=- (Base,Irq for non-standard port) Don't leave this
line blank! If line above is 0 this line will be
ignored.
c:\pcb\menus\dirs <=- (Location of your file directory menu. You need to
have both a non-graphics and graphics version of
this file available. Example: DIRS and DIRSG
NiteLite.zip <=- (Change the name of the .ZIP file PowerList creates)
60 <=- (Number of dir files available)
c:\pcb\gen\dir.lst <=- (Location of the PCBoard Dir.lst file)
c:\pcb\gen\upld <=- (Location of upload dir file)
c:pcb\gen\dos1 <=- (From here to the end of the config file is the
c:pcb\gen\dos2 complete path and filename of each dir file you
c:\pcb\gen\dos3 want to be accessable by PowerList. This is a big
c:\pcb\gen\dos4 change from 3.9 and lower. Files can now be in
c:\pcb\gen\dos5 any location. These lines are needed only for
non-PCBoard systems.)
etc.
Example configuration file for|DOOR.SYS|
---------------------------------------
C:\BBS\DOOR.SYS <=- (Full pathname of your DOOR.SYS file)
The NITE-LITE bbs <=- (Change this to your BBS name)
Mike <=- (The Sysop's first name)
Weaver <=- (The Sysop's last name)
PCBOARD <=- (BBS type must be in caps - only PCB support for now
662345922 <=- (Your registration #) Use this one till you get one
1 <=- (1 = non-standard comport 0 = normal comports)
2e8,5 <=- (Base,Irq for non-standard port) Don't leave this
line blank! If line above is 0 this line will be
ignored.
c:\pcb\menus\dirs <=- (Location of your file directory menu. You need to
have both a non-graphics and graphics version of
this file available. Example: DIRS and DIRSG
NiteLite.zip <=- (Change the name of the .ZIP file PowerList creates)
60 <=- (Number of dir files available)
c:\pcb\gen\dir.lst <=- (Location of the PCBoard Dir.lst file)
c:\pcb\gen\upld <=- (Location of upload dir file)
c:pcb\gen\dos1 <=- (From here to the end of the config file is the
c:pcb\gen\dos2 complete path and filename of each dir file you
c:\pcb\gen\dos3 want to be accessable by PowerList. This is a big
c:\pcb\gen\dos4 change from 3.9 and lower. Files can now be in
c:\pcb\gen\dos5 any location. These lines are needed only for
non-PCBoard systems.)
etc.
Example configuration file for|USERINFO.DAT|
-------------------------------------------
C:\BBS\USERINFO.DAT <=- (Full pathname of your USERINFO.DAT file)
The NITE-LITE bbs <=- (Change this to your BBS name)
Mike <=- (The Sysop's first name)
Weaver <=- (The Sysop's last name)
PCBOARD <=- (BBS type must be in caps - only PCB support for now
662345922 <=- (Your registration #) Use this one till you get one
1 <=- (1 = non-standard comport 0 = normal comports)
2e8,5 <=- (Base,Irq for non-standard port) Don't leave this
line blank! If line above is 0 this line will be
ignored.
c:\pcb\menus\dirs <=- (Location of your file directory menu. You need to
have both a non-graphics and graphics version of
this file available. Example: DIRS and DIRSG
NiteLite.zip <=- (Change the name of the .ZIP file PowerList creates)
60 <=- (Number of dir files available)
c:\pcb\gen\dir.lst <=- (Location of the PCBoard Dir.lst file)
c:\pcb\gen\upld <=- (Location of upload dir file)
c:pcb\gen\dos1 <=- (From here to the end of the config file is the
c:pcb\gen\dos2 complete path and filename of each dir file you
c:\pcb\gen\dos3 want to be accessable by PowerList. This is a big
c:\pcb\gen\dos4 change from 3.9 and lower. Files can now be in
c:\pcb\gen\dos5 any location. These lines are needed only for
non-PCBoard systems.)
etc.
NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
Example configuration file for|CALLINFO.BBS|
-------------------------------------------
C:\BBS\CALLINFO.BBS <=- (Full pathname of your CALLINFO.BBS file)
The NITE-LITE bbs <=- (Change this to your BBS name)
Mike <=- (The Sysop's first name)
Weaver <=- (The Sysop's last name)
PCBOARD <=- (BBS type must be in caps - only PCB support for now
662345922 <=- (Your registration #) Use this one till you get one
1 <=- (1 = non-standard comport 0 = normal comports)
2e8,5 <=- (Base,Irq for non-standard port) Don't leave this
line blank! If line above is 0 this line will be
ignored.
c:\pcb\menus\dirs <=- (Location of your file directory menu. You need to
have both a non-graphics and graphics version of
this file available. Example: DIRS and DIRSG
NiteLite.zip <=- (Change the name of the .ZIP file PowerList creates)
60 <=- (Number of dir files available)
c:\pcb\gen\dir.lst <=- (Location of the PCBoard Dir.lst file)
c:\pcb\gen\upld <=- (Location of upload dir file)
c:pcb\gen\dos1 <=- (From here to the end of the config file is the
c:pcb\gen\dos2 complete path and filename of each dir file you
c:\pcb\gen\dos3 want to be accessable by PowerList. This is a big
c:\pcb\gen\dos4 change from 3.9 and lower. Files can now be in
c:\pcb\gen\dos5 any location. These lines are needed only for
non-PCBoard systems.)
etc.
Example configuration file for|DORINFOx.DEF|
-------------------------------------------
C:\BBS\DORINFOx.DEF <=- (Full pathname of your DORINFOx.DEF file)
<=- (Change this to your BBS name)
The NITE-LITE bbs <=- (The Sysop's first name)
Mike <=- (The Sysop's last name)
Weaver <=- (Your registration #) Use this one till you get one
PCBOARD <=- (BBS type must be in caps - only PCB support for now
662345922 <=- (Location of your file directory menu)
1 <=- (1 = non-standard comport 0 = normal comports)
2e8,5 <=- (Base,Irq for non-standard port) Don't leave this
line blank! If line above is 0 this line will be
ignored.
c:\pcb\menus\dirs <=- (Location of your file directory menu. You need to
have both a non-graphics and graphics version of
this file available. Example: DIRS and DIRSG
NiteLite.zip <=- (Change the name of the .ZIP file PowerList creates)
60 <=- (From here to the end of the config file is the
c:\pcb\gen\dir.lst <=- (Location of the PCBoard Dir.lst file)
c:\pcb\gen\upld <=- (Location of upload dir file)
c:pcb\gen\dos1 <=- (From here to the end of the config file is the
c:pcb\gen\dos2 complete path and filename of each dir file you
c:\pcb\gen\dos3 want to be accessable by PowerList. This is a big
c:\pcb\gen\dos4 change from 3.9 and lower. Files can now be in
c:\pcb\gen\dos5 any location. These lines are needed only for
non-PCBoard systems.)
etc.
Example configuration file for|SFDOORS.DAT|
------------------------------------------
C:\BBS\SFDOORS.DAT <=- (Full pathname of your SFDOORS.DAT file)
The NITE-LITE bbs <=- (Change this to your BBS name)
Mike <=- (The Sysop's first name)
Weaver <=- (The Sysop's last name)
PCBOARD <=- (BBS type must be in caps - only PCB support for now
662345922 <=- (Your registration #) Use this one till you get one
1 <=- (1 = non-standard comport 0 = normal comports)
2e8,5 <=- (Base,Irq for non-standard port) Don't leave this
line blank! If line above is 0 this line will be
ignored.
c:\pcb\menus\dirs <=- (Location of your file directory menu. You need to
have both a non-graphics and graphics version of
this file available. Example: DIRS and DIRSG
NiteLite.zip <=- (Change the name of the .ZIP file PowerList creates)
60 <=- (Number of dir files available)
c:\pcb\gen\dir.lst <=- (Location of the PCBoard Dir.lst file)
c:\pcb\gen\upld <=- (Location of upload dir file)
c:pcb\gen\dos1 <=- (From here to the end of the config file is the
c:pcb\gen\dos2 complete path and filename of each dir file you
c:\pcb\gen\dos3 want to be accessable by PowerList. This is a big
c:\pcb\gen\dos4 change from 3.9 and lower. Files can now be in
c:\pcb\gen\dos5 any location. These lines are needed only for
non-PCBoard systems.)
etc.
Example configuration file for|CHAIN.TXT|
----------------------------------------
C:\BBS\CHAIN.TXT <=- (Full pathname of your CHAIN.TXT file)
The NITE-LITE bbs <=- (Change this to your BBS name)
Mike <=- (The Sysop's first name)
Weaver <=- (The Sysop's last name)
PCBOARD <=- (BBS type must be in caps - only PCB support for now
662345922 <=- (Your registration #) Use this one till you get one
1 <=- (1 = non-standard comport 0 = normal comports)
2e8,5 <=- (Base,Irq for non-standard port) Don't leave this
line blank! If line above is 0 this line will be
ignored.
c:\pcb\menus\dirs <=- (Location of your file directory menu. You need to
have both a non-graphics and graphics version of
this file available. Example: DIRS and DIRSG
NiteLite.zip <=- (Change the name of the .ZIP file PowerList creates)
60 <=- (Number of dir files available)
c:\pcb\gen\dir.lst <=- (Location of the PCBoard Dir.lst file)
c:\pcb\gen\upld <=- (Location of upload dir file)
c:pcb\gen\dos1 <=- (From here to the end of the config file is the
c:pcb\gen\dos2 complete path and filename of each dir file you
c:\pcb\gen\dos3 want to be accessable by PowerList. This is a big
c:\pcb\gen\dos4 change from 3.9 and lower. Files can now be in
c:\pcb\gen\dos5 any location. These lines are needed only for
non-PCBoard systems.)
etc.
Example configuration file for|TRIBBS.SYS|
----------------------------------------
C:\BBS\TRIBBS.SYS <=- (Full pathname of your TRIBBS.SYS file)
The NITE-LITE bbs <=- (Change this to your BBS name)
Mike <=- (The Sysop's first name)
Weaver <=- (The Sysop's last name)
PCBOARD <=- (BBS type must be in caps - only PCB support for now
662345922 <=- (Your registration #) Use this one till you get one
1 <=- (1 = non-standard comport 0 = normal comports)
2e8,5 <=- (Base,Irq for non-standard port) Don't leave this
line blank! If line above is 0 this line will be
ignored.
c:\pcb\menus\dirs <=- (Location of your file directory menu. You need to
have both a non-graphics and graphics version of
this file available. Example: DIRS and DIRSG
NiteLite.zip <=- (Change the name of the .ZIP file PowerList creates)
60 <=- (Number of dir files available)
c:\pcb\gen\dir.lst <=- (Location of the PCBoard Dir.lst file)
c:\pcb\gen\upld <=- (Location of upload dir file)
c:pcb\gen\dos1 <=- (From here to the end of the config file is the
c:pcb\gen\dos2 complete path and filename of each dir file you
c:\pcb\gen\dos3 want to be accessable by PowerList. This is a big
c:\pcb\gen\dos4 change from 3.9 and lower. Files can now be in
c:\pcb\gen\dos5 any location. These lines are needed only for
non-PCBoard systems.)
etc.
Line 1 -> Is the location of your BBS info file. The program requires
the complete path and filename. I recommend using USERS.SYS
for PCBoard use.
Line 2 -> The name of your BBS goes here.
Line 3 -> The SysOp's first name.
Line 4 -> The SysOp's last name.
Line 5 -> This is for BBS type. Currently the only type that will work
in this field is PCBOARD (in caps!) More types will be support-
ed as I learn the file formats needed. If you are not running
PCBoard use NONE (in caps!)
Line 6 -> This is where you put your serial number once you register the
program. Until then use any number you like but don't leave
this line out or the door will crash!
Line 7 -> This line tells DSZ whether or not you are using non-standard
comports. 0 means you are not and 1 means you are.
Line 8 -> This is where you define your non-standard port configuration.
The format is BASE,IRQ. Example: 2e8,5. If you are not using
non-standard ports you must still have something on this
line. I recommend "Disabled" without the quoates. As with
all the other lines in the .cfg file this line cannot be left
out!
Line 9 -> This is the location of your file directory menu. The example
above is from my system, use whatever you use in PCBSetup.
Or you can create a special directory menu if you like just
be sure to tell the config file where to find it. Create a non-
graphic and graphic version of the menu and append a "G" to the
graphic version. Example: DIRS and DIRSG
Line 10-> Here you can specify a new name for the .ZIP file that Power
List creates. Be sure to use a valid filename.
Line 11-> This number represents the total number of dir files on your
system. This number needs to match the number of entries in
the next instruction.
Line 12-> The complete path and filename of your PCBoard DIR.LST file
as specified in PCBSetup.
Line 13-> The complete path and filename of your PCBoard upload dir
file as specified in PCBSetup
Line 14-> Lines from this point on are only needed if you are using a
BBS other than PCBoard.
From here to the end of the .cfg file is where you tell the
program the complete path and filename of each of your systems
dir files. Using this method seemed more versatile to me.
You can have dir files that are kept in different locations if
need be. The unregistered version is not crippled and will
handle as many directories as you need to. However if you use
the door Please Register.
Environment Variables
---------------------
PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
variables. Non-PCBoard systems may also use these variables by including
the following in either your BBS batch or AUTOEXEC.BAT
SET PCBDRIVE=C: <- Drive letter of your BBS files
SET PCBDIR=\BBSDIR <- Path to your BBS files
Then in your Door .CNF file instead of putting C:\BBSDIR\DOOR.SYS, you
would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
.CNF file for multi-node operation!
To specify a non-standard IRQ, put the IRQ number after the .CNF on the
command line. For example:
PWRLIST PWRLIST.CNF /5
or using the PCBDRIVE procedure: SET IRQ=5 and use
PWRLIST PWRLIST.CNF /%IRQ%
This tells the program to use IRQ 5 instead of the standard IRQ.
!!!! I have only run and tested this door with PCBoard 14.5a and I cannot !!!!
!!!! attest to its ability to run on any other systems. Consider yourself !!!!
!!!! warned in advance. !!!!
Example Batch File
-------------------
A sample batch file is included and is similer to the following:
ECHO OFF
CD\DOORS\PWRLIST <=- Switch to the door's Directory.
PWRLIST PWRLIST.CNF <=- Execute the door program and pass the
configuration filename to the program.
CD\PCB <=- Go back to PCB DIR when user exits door.
BOARD <=- Restart BBS.
A sample batch file for running the registered seamless version which
assumes of course you run in shelled mode.
ECHO OFF
CD\DOORS\PWRLIST <=- Switch to the door's Directory.
PWRLISTX PWRLIST.CNF <=- Execute the door program and pass the
configuration filename to the program.
CD\PCB <=- Go back to PCB DIR when user exits door.
EXIT <=- Restart BBS.
This Door is multi-node compatible so you may run more than 1 node from
the same .CNF file provided the path to your system file (DORINFOx.DEF,
CALLINFO.BBS, etc) is exactly the same unless you are using environment
variables, (q.v.)
Sysop Keys
----------
F3 - Toggles the printer On/Off. Value is passed to PCBoard and/or
written to DOOR.SYS and USERS.SYS
F4 - Toggles the Page Bell on/off. Value is passed to PCBoard
and/or written to DOOR.SYS and USERS.SYS
F5 - DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
F7 - Toggles the Caller Alarm On/Off. Value is passed to PCBoard
and/or written to DOOR.SYS and USERS.SYS
F8 - Returns the caller involuntarily to the BBS.
F9 - Toggles the local display On/Off. Value is passed to PCBoard
and/or written to DOOR.SYS and USERS.SYS
F10 - Activates SysOp CHAT mode within the DOOR.
ESC - Deactivates CHAT mode. DOOR is resumed.
UP - Give the caller extra time while in the DOOR.
DN - Subtract time from the caller while in the DOOR.
HOME - HELP key for Status Line options.
ALT-N - SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
ALT-X - PCBoard will exit after current caller logs off. Value is
passed to PCBoard. Not available on non-PCBoard systems.
One last thing I am terrible at writing so if these docs seem hard to read
or use it is probably because they are. <GRIN>
CREDITS
-------
I want to thank Todd Stephens for his unending help when my
needs overcome my ability.
I also want to thank Ted Freeman for his great program Door-
Frame, as well as for his never ending help as I tried to
convert Power List over to use DoorFrame and in turn be much
more versatile.
OK I'm finished, send the millions to:
Mike Weaver
% The NITE-LITE bbs
Rt. 1 Box 231b
159 Moatsewell Rd.
Philadelphia, Tn.
37846